home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Topik / Topik - Disk 36 - Archivers (19xx)(Topik Public Domain)(PD)[WB].zip / Topik - Disk 36 - Archivers (19xx)(Topik Public Domain)(PD)[WB].adf / Zap / ZAP_DOCS < prev    next >
Text File  |  1990-10-07  |  12KB  |  339 lines

  1.  
  2. *** TOPIK Note : Zap is here, accessible from the CLI.
  3.  *
  4.  *
  5.  
  6. Hmmm.. now what can I do tonight?
  7.  
  8. I know! I'll go on the POWERGRID BBS and download the amazing
  9. ZAP documents file!
  10.  
  11. ATDP 0670-540073
  12.  
  13. RINGING
  14. CONNECT 9600
  15.  
  16.  
  17.                 DOWNLOADED FROM THE POWERGRID BBS!
  18.  
  19.  
  20.                 **********************************
  21.                 **********************************
  22.                 **                              **
  23.                 **                              **
  24.                 **      ZZZZZZ   AA   PPPPPP    **
  25.                 **      Z   ZZ  AAAA   PP  PP   **
  26.                 **         ZZ  AA  AA  PP  PP   **
  27.                 **        ZZ   AAAAAA  PPPPP    **
  28.                 **       ZZ  Z AA  AA  PP       **
  29.                 **      ZZZZZZ AA  AA PPPP      **
  30.                 **                              **
  31.                 **                              **
  32.                 **********************************
  33.                 **********************************
  34.  
  35.                   Written by *GREMLIN* of MAYHEM!
  36.                   ===============================
  37.  
  38.                      Docs for V1.41 (31/1/90)
  39.                      ========================
  40.  
  41.  
  42.  
  43.         About ZAP
  44.         =========
  45. I got into serious modem usage when I got a 9600HST modem (It's not worth
  46. it if you've got anything slower!!), and the first thing I noticed was that
  47. EVERYONE used this 'Warp' program to crunch disks. I downloaded it and the
  48. first question was *WHY??*  It's RUBBISH! It's massively long, it's written
  49. in C, and worst of all, it's SO -=S L O W=-!!  5 minutes to uncrunch a disk
  50. is just ridiculous!  And as for crunching disks.. you could have a long
  51. holiday in Barbados while it crunches a blank disk!
  52.  
  53.  
  54.         C (or why Kernighan and Richie should be tied to a post and shot)
  55.         ===================================================================
  56. Well, I'm a professional programmer (I'm not telling you what I've written -
  57. you never know who's listening!) and I've written my own compression routines
  58. before for use on games. It must be said now, that I'm not a fan of the C
  59. language, or at least, of the current implementations of it. It's fine for
  60. writing utilities that don't need to be fast or compact, but for ANYTHING
  61. else it is useless!
  62.  
  63. One of it's main selling points is that it is supposedly easy to use and
  64. portable from one machine to another - what a joke! The company I work
  65. for wrote the strategy part of a game on the IBM PC (in Lattice C) simply
  66. so it could be easily ported to the ST and Amiga while the machine-specific
  67. bits (i.e. graphics routines, animated stuff, etc) were rewritten from 8086
  68. to 68000. ...It took less time to rewrite the machine code than it did to
  69. get the C code to work - and that was using the SAME Lattice compiler on the
  70. 68000 machines!  As for ease of use.. Can you learn C in two days?
  71.  
  72. Ok.. enough of C (thankfully!)
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.         How to use ZAP
  89.         ==============
  90.  
  91.  
  92. 1: Crunching a disk.
  93. --------------------
  94.  
  95. So, you have a disk you want to crunch. Is it all in DOS format?
  96.  
  97. Most likely, it will be..
  98. If you don't know, you can either try it, or you can save time and run it
  99. through the CHECKDISK option on a copier like X-Copy. If any tracks
  100. come up as not green then either the disk is in a non-dos format, or
  101. you have an error on it.
  102.  
  103. If you suspect an error, use the DOSCOPY+ option to copy the disk
  104. and correct the error. If it has lots of non-dos tracks,
  105. you will probably have to find some other way of crunching it,
  106. as the current version of Zap (V1.41) does not support non-dos disk
  107. formats.
  108.  
  109. Right, now you have your source disk sorted out, here's how to
  110. crunch it:
  111.  
  112. 1) Do you want to crunch it to ramdisk? If not, see step 2.
  113.  There's usually no point; you will want to copy it to floppy/harddisk
  114.  afterwards anyway, but if you are really mad and have enough memory,
  115.  make sure that the ramdisk is installed up BEFORE you run Zap. The
  116.  RAM: device is only installed into your machine the first time you
  117.  try and use it after booting the machine, so to avoid problems, type
  118.  something like DIR RAM: . This will ensure the ram disk is all
  119.  set up and ok.
  120.   You could use the recoverable ram disk RAD: instead if you want to,
  121.  assuming it is configured to be big enough, but that is your problem,
  122.  and is a bit beyond the scope of this document to tell you how to set
  123.  it all up if you don't know.
  124.  
  125. 2) If crunching to floppy, make sure you have 2 drives and a nice
  126.  formatted disk with enough space to hold the crunched file.
  127.  
  128. 3) If crunching to hard disk, you have no problem!
  129.  
  130. 4) Would you like some text to be displayed when someone
  131.  else comes to uncrunch the disk? You could advertise yourself to
  132.  the world!  If so, use a text editor (any one will do) to make up
  133.  a file with your text in it. (you can include ANSI codes - if you know
  134.  what they are!!)
  135.  
  136. 5) type
  137.         ZAP R (filename)
  138.  Where (filename) is the name of the device/file that you want the
  139.  crunched file to go to. E.g.   DF1:Fred   or  DH0:Zapstuff/Megademo
  140.  or  RAM:SillyName     The filename will have ".ZAP" added on the
  141.  end of it, unless you put it on the name yourself.
  142.  
  143. 6) You will then be asked what crunch depth you require. This simply
  144.  determines the amount of time the disk will take to crunch, and thereby
  145.  how short the resulting file will be. Basically, experiment. The time
  146.  taken will vary from about 40 seconds for a blank disk on the fastest
  147.  setting (i.e. '0') to an hour or more for a full disk on the slowest
  148.  setting ('9').
  149.  Note that numbers over about 4 or 5 will take correspondingly
  150.  longer to crunch but will yield progressively less gain, so it's only
  151.  worth using '9' if you are going to leave it overnight, having said
  152.  that try to use '1' or '2' instead of '0' if you can, as the difference is
  153.  always worth it.
  154.  
  155. 7) After that you will be asked for the name of the text file you want
  156.  to incorporate in the crunched file, if any. If you have prepared a file
  157.  before (you were warned!!), enter the name now. If not, just press
  158.  return.
  159.  
  160. 8) When prompted to put the disk in, bung it in DF0, and wait for a second
  161.  or two. If the disk grinds and a requestor comes up saying something
  162.  like 'Key 880 checksum error' or 'Error validating disk' then just click
  163.  on CANCEL until they go away! Then press return to start.
  164.  
  165. 8) That's it! The disk will be read in and compressed (accompanied by much
  166.  screen-flashing) and any errors will be reported. If there are no problems
  167.  Zap will tell you after every block of 8 tracks how well they crunched.
  168.  
  169.  Finally you will be told the total file length in kilobytes. You can now
  170.  do what you like with the crunched file (e.g. upload it onto a bulletin
  171.  board, save it on hard disk, whatever)
  172.  
  173. For those of you who wonder why there are not millions of options
  174. to use (like WARP) e.g. 1,79,NOZERO, etc,etc the answer is that
  175. ZAP handles them all automatically!
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182. 2: Uncrunching a disk.
  183. ----------------------
  184.  A file crunched with ZAP can be recognised by the ".ZAP" extension
  185.  it should have.
  186.  
  187.  Type ZAP W (filename)
  188.  
  189.  You don't have to put the ".ZAP" extension on the name if you don't
  190.  want to, but it will be assumed.
  191.  
  192.  Put a disk (it doesn't have to be blank or even formatted) into DF0,
  193.  and click on CANCEL on any silly requestors that may appear. Then
  194.  press return. At this point if someone crunched the disk with a text
  195.  file on it, the text will be displayed. If not, the disk will be
  196.  uncrunched and written to DF0. The boot block will be displayed so
  197.  you can see if it has any obvious viruses on.
  198.  
  199.  That's it!
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206. 3: Error messages
  207. -----------------
  208. You can get two sorts of error messages;
  209.  
  210.  Dos messages (familiar, like 'disk full' or something short like
  211.  'File Error' which usually means the file was not found)
  212.  
  213.  Trackdisk messages (unfamiliar, but quite obvious, like WRITEPROT
  214.  means the disk was writeprotected. If you get something you don't
  215.  know, like BADSECHDR then it means that there is an error on the
  216.  disk you are crunching. See earlier) You can (R)etry or (C)ancel
  217.  with these messages.
  218.  
  219.  
  220.  
  221.  
  222.  
  223. 4: Miscellaneous problems
  224. -------------------------
  225. If it doesn't end in ".ZAP" and you are not sure, or there is some major
  226. problem in unzapping the file, try:
  227.         TYPE name OPT H
  228. which will display the file in hex and ascii for you. Right at the start
  229. of the file should be "ZAP V?.?? (C) 19?? GREMLIN of MAYHEM" or some
  230. such message. If this is not there, then the file wasn't ZAPped. If the
  231. first part of the version number is greater then 1 (the release that this
  232. docs file was written for) then it has been crunched with a later version
  233. of Zap that uses a new and incompatible compression algorithm. Get the
  234. latest version!
  235.  
  236. Anything else? Tell me via POWERGRID (see bottom of file)
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.         Technical Stuff
  252.         ===============
  253. For the techy people amongst the massed throngs (?!) of you readers,
  254. Zap uses a modified Runlength Encode as a preprocessor, followed by an
  255. ultra-optimised Lempel-Zev algorithm. This Lempel-Zev technique is used
  256. in virtually every cruncher around nowadays, and is the best algorithm
  257. for general data compression - Those wishing to argue can go and eat
  258. their own toenails!  There is another algorigm, Huffman coding, which
  259. is much faster, but is not usually so efficient, so I decided against
  260. using it.
  261.  
  262. The main problem with Lempel-Zev is that it requires a vast amount of
  263. data searching, and so tends to take a very long time to run. The total
  264. time taken is determined by how far you search for each byte, and that
  265. is why the user is usually asked for the search depth for the program
  266. to use. If you are interested, the 0-9 numbers of Zap can be worked
  267. out as byte depths by 128+(number*256) i.e. 0 will search 128($80)
  268. bytes.
  269.  
  270. Most crunchers (for example the classic 'Bytekiller') are
  271. written by people who tend to know less about writing really superfast
  272. 68000 code, and more about writing demos or business programs!
  273. Anyway, Zap was written simply for speed and efficiency, and I like
  274. to think I achieved it to some extent.
  275.  
  276. The other thing that makes Zap fast, is the fact that it is the only
  277. cruncher to use Amiga multitasking properly. Instead of using the
  278. reading a track, crunching it, and then writing it out, Zap uses
  279. a double-buffer system where the next 8 cylinders are read at the same
  280. time as the previous 8 are being crunched. Therefore there is never any
  281. time wasted waiting for disk access to finish. This makes quite a
  282. difference when crunching a disk, but really comes into its own when
  283. uncrunching, when the disk is written to virtually non-stop. If you
  284. have the source file in ramdisk, you can uncrunch a whole disk in about
  285. 45 seconds, as opposed to 4 minutes using WARP!
  286.  
  287. Zap uses the trackdisk command TD_FORMAT rather than TD_WRITE, so the
  288. destination disk doesn't have to be formatted first. To date (V1.41) it
  289. does not do verification on written tracks, although I'll put this on
  290. a later version.
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.         Stuff I'll try to put in the next release
  298.         =========================================
  299. 1) Selection of tracks to be crunched, so you can crunch part of a disk
  300.    if you like.
  301. 2) I'll put back in the bitmap option, but I tend to think it's more
  302.    trouble than it's worth to use.
  303. 3) Automatic handling of non-dos tracks (i.e. MFM mode) ..maybe
  304. 4) Verify option when writing.
  305. 5) Even better compression (I have had an idea that might well improve the
  306.    crunching by a considerable amount!!)
  307. 6) Even faster crunching (there's probably something I can optimise a
  308.    bit more!)
  309. 7) Bob-demo and Soundtracker music when crunching. (Joke!!)
  310. 8) Disk-validation disabling when source or target disks are inserted (minor!)
  311. 9) Crunching/Uncrunching to different drives (only floppies though!)
  312. 10) Flashing powerlight when crunching (so you can see if it's finished
  313.    when doing those all-nighters with the monitor turned off)
  314.  
  315.  
  316.  
  317. Any other suggestions or bug reports?
  318.                          ring the
  319.  
  320.                 POWERGRID BBS (UK) on +44(0)670-540073
  321.  
  322.         2400-14.4k (no-one below 2400!) 24hrs 300Meg on-line!
  323.  
  324.                        Mail to: GREMLIN
  325.  
  326.  
  327.  
  328.         Now y'all be sure to Have A Nice Day!!! (they REALLY say that!)
  329.  
  330.                         ...And Come Back Real Soon, Y'Hear?
  331.  
  332. Click!
  333.  
  334. NO CARRIER
  335. OK
  336.  
  337. Gee! Wasn't that fun?
  338.  
  339.